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The interface models the object as a set of input streams and a set of output streams each 
identified by a 0-based index. 

The DMO_MEDIA_TYPE structure is used to identify all types of multimedia data. 



IMediaObject methods and structures 

Data buffers are wrapped inside an IMediaBuffer interface, a pointer to which is stored in each of 
the below structures. The IMediaBuffer interface contains a few simple methods to access the 
data pointer and the buffer's length: 

interface IMediaBuffer : lUnknown 
{ 

HRESULT SetLength( 
[in] DWORD cbLength 

); 

HRESULT GetMaxLength( 
[out] DWORD *pcbMaxLength 

): 

HRESULT GetBufferAndLength( 
[out] BYTE **ppBuffer. // not filled if NULL 
[out] DWORD *pcbLength // not filled if NULL 

): 

} 

DMO_MEDIA_TYPE 
{ 

GUID majortype; 

GUID subtype; 

BOOL bFixedSizeSamples; 

BOOL bTemporalCompression; 

ULONG ISampleSize; 

GUID formattype; 

lUnknown *pUnk; 

ULONG cbFormat; 

BYTE *pbFormat; 

} 

This defines the media type structure. This structure exactly matches the DirectShow 
AM_MEDIA_TYPE structure and is given here for reference. 
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DMO_OUTPUT_DATA_BUFFER 
{ 

IMediaByffer 
DWORD 

REFERENCE.TIME 
REFERENCE TIME 



*pBuffer; 
dwFlags; 
rtTimeStamp; 
rtTimeLength; 



Pointer to buffer wrapper Interface 
Can be NULL 



} 

pBuffer 
dwFlags (out) 

This nnust be a connbination of the following flag values (or 0) 

DMO_OUTPUT_DATA_BUFFERF_TIME 
rtTimestamp is valid 

DMO_OUTPUT_DATA_BUFFERF_TIMELENGTH 
rtTimeLength is valid 

DMO_OUTPUT_DATA_BUFFERFJNC0MPLETE 

Another buffer is required to continue process the input 

DMO_OUTPUT_DATA_BUFFERF_SYNCPOINT 
Syncpoint at the beginning of the data^ 



rtTimestamp 
rtTimelength 



Start time 
Length 



HRESULT GetStreamCount(DWORD ^pclnputStreams, DWORD ^pcOutputStreams) 

Returns the number of each type of stream. It is possible for objects to have no input 
streams or no output streams. 



Parameters 

pclnputStreams 
pcOutputStreams 

Return Values 

S_OK 

E_POINTER 
Failure code 



Number of input streams 
Number of output streams 



Success 

One of the parameters was NULL 
Some other failure 



^ Implicit syncpoints (e.g., regularly occurring syncpoints in an audio stream) must be reflected by 
this flag. In addition, audio buffers must always begin at a syncpoint. 
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HRESULT GetlnputStreamlnfo(DWORD dwInputStreamlndex, DWORD ^pdwFlags) 

Returns information about an input stream. This information does not change for the 
lifetime of this stream. 



Parameters 



dwInputStreamlndex Zero based index of input stream 

pdwFlags DMOJNPUTJNFOF_HOLDS_BUFFERS 

The Media Object may hold on to 
multiple input buffers for this stream 



Return Values 



S_OK 

E_POINTER 

DMO_EJNVALID_STREAM 
Failure code 



Success 

pdwFlags was NULL 
Stream index out of range 
Some other failure 



HRESULT GetOutputStreamlnfo(DWORD dwOutputStreamlndex, DWORD 
^pdwFlags) 

Returns information about an output stream. This information does not change for the 
lifetime of this stream. 



Parameters 



dwOutputStreamlndex Zero based index of output stream 

pdwFlags DMO_OUTPUT_STREAMF_WHOLE_SAMPLES 

Output contains complete samples 
DMO_OUTPUT_STREAMF_SINGLE_SAMPLE 

Output contains 1 sample 
DMO_OUTPUT_STREAMF_FIXED_SAMPLE_SIZE 

Output samples are fixed size 
DMO_OUTPUT_STREAMF_DISCARDABLE 

Output can be discarded in ProcessOutput 
DMO_OUTPUT_STREAMF_OPTIONAL 

Processing this stream is optional 



Return Values 



S_OK 

E_POINTER 

DMO_E_IN.VALID_STREAM 
Failure code 



Success 

pdwFlags was NULL 
Stream index out of range 
Some other failure 



HRESULT GetlnputType(DWORD dwInputStreamlndex, DWORD dwTypelndex, 
DMO_MEDIA_TYPE *pmt) 

Get the dwTypelndex type for the input stream dwInputStreamlndex. The Media Type 
returned in pmt will be ovenwritten if the method is successful. The format block of the 
Media Type must be freed by calling CoTaskMemFree(). Often input types will contain a 
NULL format block. 
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The types are enumerated in preference order with the most preferred type 
corresponding to a type index of 0. 

If the call is successful the caller should free the output media type by calling 
MoFreeMediaTypeO when it's done. 

For convenience of implementation it's possible that some types will be enumerated 
which will fail when used in SetOutputTypeQ. . 

Parameters 

dwInputStreamlndex Zero based input stream index 

dwTypelndex Zero based type index 

pmt Pointer to Media type to return 

Return Values 

S_OK Success 

S_FALSE Type index out of range 

DMO_EJNVALID_STREAM Stream index out of range 

E OUTOFMEMORY Could not allocate format block or some 



HRESULT GetOutputType(DWORD dwOutputStreamlndex, DWORD dwTypelndex, 
DMO_MEDIA_TYPE *pmt) 

Get the dwTypelndex type for the output stream dwOutputStreamindex. The Media 
Type returned in pmt will be overwritten if the method is successful. The format block of 
the Media Type must be freed by calling CoTaskMemFreeQ. 

The types are enumerated in preference order with the most preferred type 
corresponding to a type index of 0. 

If the input type is not set for some input stream this call may fail or return a type with a 
NULL format block. 

If the call is successful the caller should free the output media type by calling 
MoFreeMediaTypeO when it's done. 

For convenience of implementation it's possible that some types will be enumerated 
which will fail when used in SetOutputType(). 

Parameters 

dwOutputStreamindex Zero based output stream index 

dwTypelndex Zero based type index 

pmt Pointer to Media type to return 

Return Values 

S_OK Success 

S_FALSE Type index out of range 

DMO_EJNVALID_STREAM Stream index out of range 



Failure code 



other memory failure 
Some other failure 
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E_OUTOFMEMORY 
Failure code 



Could not allocate format block or some 
other memory failure 
Some other failure 



HRESULT SetlnputType(DWORD dwInputStreamlndex, const DMO.MEDIA.TYPE 
*pmt, DWORD dwFlags) 

Set a Media Type for an input stream. This call is processed in the context of the types 
currently set for other streams. 

Parameters 



dwInputStreamlndex Zero based input stream index 

pmt Type to set 

dwFlags This must be a combination of the following 

flag values (or 0) 



Return Values 



DMO_SET_TYPEF_TEST_ONLY 

Just check if this type can be set, do 

not set it 
DMO_SET_TYPEF_CLEAR 

Clears the type so that no type is set 

for this stream 



S_OK 
S_FALSE 

DMO_E_TYPE_NOT_ACCEPTED 
Failure code 
E INVALIDARG 



Type was set 
Type cannot be set 
Type is not acceptable 
Some other failure 
Invalid argument 



HRESULT SetOutputType(DWORD dwOutputStreamlndex, const 
DMO_MEDIA_TYPE *pmt, DWORD dwFlags) 

Set a Media Type for an output stream. This call is processed in the context of the types 
currently set for other streams. 



Parameters 



dwOutputStreamlndex Zero based output stream index 

pmt Type to set 

dwFlags This must be a combination of the following 

flag values (or 0) 



DMO_SET_TYPEF_TEST_ONLY 

Just check if this type can be set, do 

not set it 
DMO_SET_TYPEF_CLEAR 

Clears the type so that no type is set 

for this stream 



Return Values 



S OK 



Type can be set 
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S_FALSE 

DMO_E_TYPE_NOT_ACCEPTED 
Failure code 



Type cannot be set 
Type is not acceptable 
Some other failure 



HRESULT GetlnputCurrentType(DWORD dwInputStreamlndex, DMO_MEDIA_TYPE *pmt) 

Get the Media Type for an input stream. 

If the call is successful the caller should free the output media type by calling 
MoFreeMediaTypeO when ifs done. 



Parameters 



dwInputStreamlndex 
pmt 



Return Values 



S_OK 

DMO_E_TYPE_NOT_SET 
E_OUTOFMEMORY 
Failure code 



Zero based input stream index 

Type returned here 

The type must be freed by calling 

MoFreeMediaTypeO if this call was successful 



Type was returned 
Type is not set 

Format block could not be allocated 
Some other failure 



HRESULT GetOutputCurrentType(DWORD dwOutputStreamlndex, 
DMO_MEDIA_TYPE *pmt) 

Get the Media Type for an output stream. 

If the call is successful the caller should free the output media type by calling 
MoFreeMediaTypeO when it's done. 



Parameters 



dwOutputStreamlndex 
pmt 



Return Values 



S_OK 

DMO_E_TYPE_NOT_SET 
E_OUTOFMEMORY 
Failure code 



Zero based output stream index 

Type returned here 

The type must be freed by calling 

MoFreeMediaTypeO if this call was successful 



Type was be set 
Type is not set 

Format block could not be allocated 
Some other failure 
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HRESULT GetlnputSizelnfo(DWORD dwInputStreamlndex, DWORD *pcbSize, 
DWORD *pcbMaxLookahead, DWORD *pdwAlignment) 

Get buffer size and alignment requirements for a given input stream. 

This method should be called after the types of all streams have been set using 
SetlnputTypeO and SetOutputType(). 

pcbMaxLookahead is only used for objects which hold on to multiple input buffers for 
lookahead. In that case the application must allow for enough buffers so that this amount 
can be retained by the object in order to generate output. For example, if the application 
decides on a fixed buffer size of dwBufferSize then it should be prepared to allocate up 
to at least: 

f pcbMaxLookahead + 2 * (dwBufferSize - 1)) / dwBufferSize 

buffers of that size to avoid running out of buffers. This number may be reduced if there 
are alignment requirements in the data. 

Parameters 



dwinputStreamlndex 
pcbSize 



pcbMaxLookahead 



pdwAlignment 



Zero based input stream index 
Returns buffer size 

This is at least the minimum size required for 
processing 

Maximum size of data held by this object if it 
AddRefs multiple input buffers 
Or 0, 

Returns buffer alignment. 1 means no 
alignment requirement. 



Return Values 



S_OK 

E_POINTER 
Failure code 



Call successful 

NULL pointer passed in 

Other failure 



HRESULT GetOutputSizelnfo(DWORD dwOutputStream Index, DWORD ''pcbSize, 
DWORD ^pdwAlignment) 

Get buffer size and alignment requirements for a given output stream. 

This method should be called after the types of all streams have been set using 
SetlnputTypeO and SetOutputType(). 

Parameters 

dwOutputStreamlndex Zero based output stream index 

pcbSize Returns buffer size 

pdwAlignment Returns buffer alignment. 1 means no 

alignment requirement. 

Return Values 



S_OK 

E POINTER 



Call successful 

NULL pointer passed in 
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Failure code 



Other failure 



HRESULT Discontinuity(DWORD dwInputStreamlndex) 

Informs the Media Object that the data is discontinuous on input stream 
dwInputStreamlndex. This can occur (for example) because there is a large gap in the 
data, because no more data is expected, or because the format of the data is changing. 

The Media Object should generate all output which can be generated from the data 
already received in calls to Processlnput() on this stream before accepting more data on 
this stream. 

Calling DiscontinuityO more than once without intermediates call to ProcesslnputO is 
equivalent to calling DiscontinuityO once. 

If the DiscontinuityO method has been called on all input streams for a Media Object 
and all output has been processed from all the output streams by calls to 
ProcessOutputO then the Media Object is in the equivalent state to the flushed state. In 
this state all buffers must be released and no more output can be generated until 
ProcesslnputO is called again. Also in this state calling FlushO has no effect. 

Parameters 

dwInputStreamlndex 0-based input stream index 
Return Values 

S OK Call was successful 



HRESULT FlushO 

Flush internally buffered data and reset any streaming state. Media types and other 
parameters such as latency are not changed. 

All Media Buffers held by all streams must be released on return from this call. 
Any incomplete processing of a discontiuity for any input stream is cancelled. 

All streams should accept input after a FlushO call. 

Parameters 



Return Values 

S_OK Successful 
Failure code Failure 
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HRESULT AllocateStreamingResourcesO 

Hint to allocate any resources necessary for processing. This method may not be called 
before the first call to ProcessOutput() and it is not required to support this method. 

Parameters 



Return Values 

S_OK Successful. Return this if the call is not 

implemented. 

Failure code Some failure occurred 

HRESULT FreeStreamingResourcesO 
Hint to free any resources necessary for processing. 
Parameters 



Return Values 

S_OK Successful. Return this if the call is not 

implemented. 

Failure code Some failure occurred 

HRESULT GetlnputStatus(DWORD dwInputStreamlndex, DWORD ^pdwFlags) 

Return input stream status. 



Parameters 

dwinputstreamlndex 0-based input stream index 

• pdwFlags DMO_INPUT_STATUSF_ACCEPT_DATA 

This stream is ready to accept data 

The setting of this flag can only change as the result 
of one of the following calls: 



ProcessOutputO 
DiscontinuityO 
Processlnput() 
FlushO 

Return Values 
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HRESULT Processlnput(DWORD dwInputStreamlndex, IMediaBuffer *pBuffer, 
DWORD dwFlags, REFERENCE.TIME rtTimeStamp, REFERENCE^TIME 
rtTimeLength) 

Deliver an input buffer for a stream. The Media Object should either process all the data 
inside this method or call IMediaBuffer: :AddRef() to hold the buffer waiting for calls to 
ProcessOutput(). When the Media Object has generated all the output it can from this 
buffer it should call IMediaBuffer: :Release() unless it needs the buffer for lookahead. 

If the Media Object calls IMediaBuffer::AddRef() the appication should not reuse a 
buffer until the matching IMediaBuffer::Release() is called. 



Parameters 



dwInputStreamlndex 
pBuffer 

dwFlags 



rtTlmeStamp 
rtTimeLength 



Zero based input stream index 
Buffer containing data 
Cannot be NULL 

Must be a combination of the following flag valus (or 0) 
DMOJNPUT_DATA_BUFFERF_TIME 
rtTlmestamp is valid 

DMOJNPUT_DATA_BUFFERF_TIMELENGTH 
rtTimeLength is valid 

DMOJNPUT_DATA_BUFFERF_SYNCPOINT 
Syncpoint at the beginning of the data 
Start timestamp in 100ns units 
Length in 100ns units 



Return Values 



S_OK Processed normally 

S_FALSE No output. 

DMO_E_NOTACCEPTING Data cannot be accepted until previous output 

has been processed by calling 
ProcessOutputO 



HRESULT ProcessOutput(DWORD dwReserved, DWORD cOutputBufferCount, 
DMO_OUTPUT_DATA_BUFFER *pOutputDataBuffers, DWORD *pdwStatus) 

Generate outputs from current input data. The status fields in the output data buffers are 
updated as a result of this call. 

The IMediaBuffer pointers in the DMO_OUTPUT_DATA_BUFFER structures should not 
be held by AddRef after return from this call (ie their reference counts should be the 
same on exit as on entry). 

Output buffer status fields are undefined if this call returns a failure code. 

After calling ProcessOutputO the application should check all output streams for the 
DMO_OUTPUT_DATA_BUFFERFJNCOMPLETE flag. It is possible, for instance, when there are 
multiple output streams, for a stream which did not report 

DMO_OUTPUT_DATA_BUFFERFJNCOMPLETE previously to report It after a subsequent call to 
ProcessOutputO. 
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Parameters 
dwFlags 



cOutputBufferCount 
pOutputDataBuffers 
pdwStatus 



Return Values 

S_OK 

Failure code 



DMO_PROCESS_OUTPUT_0ISCARD_WHEN,NO_BUFFER 

If the pBuffer member of one of the output 
buffer structures is NULL discard output 
data. 

Count of input buffers - this should be the same 
as the number of output streams. 
Array of output data buffers of size 
cOutputBufferCount. 

The Media Object should return 0 here. 



Processing was successful 
Failure in processing 



HRESULT GetlnputMaxLatency(DWORD dwInputStreamlndex, REFERENCE.TIME 
*prtMaxLatency) 

Returns the maximum latency in time between input on the stream and the corresponding 
output timestamps. Thus, for example, if input timestamped at time T generates output 
for time T-Delta then this value is the maximum possible value of Delta for the media 
types defined. This value does not take into account input buffer size. 



Parameters 

dwInputStreamlndex 
prtMaxLatency 

Return Values 

E_NOTIMPL 
S_OK 

Failure code 



0-based input stream index 
Latency 



Not implemented. Assume 0 latency 
OK 

Failure 



HRESULT SetlnputMaxLatency(DWORD dwInputStreamlndex, REFERENCE.TIME 
rtMaxLatency) 

Sets the maximum latency in time between input on the stream and the corresponding 
output timestamps. Thus, for example, if input timestamped at time T generates output 
for time T-Delta then this bounds the maximum possible value of Delta for the media 
types defined. This value does not take into account input buffer size. 



Parameters 

dwInputStreamlndex 
prtMaxLatency 

Return Values 

E.NOTIMPL 
S_OK 
E FAIL 



0-based input stream index 
Latency 



Not implemented. Latency cannot be set. 
OK 

Latency cannot be set 
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HRESULT Lock(LONG ILock) 

Acquire a lock so that multiple operations can be performed while keeping the Media 
Object serialized. 



Parameters 
LLock 

prtMax Latency 

Return Values 

S_OK 
E FAIL 



TRUE - lock 
FALSE - unlock 
Latency 



OK 

Cannot lock 



Registration 



DMO_PARTIAL MEDIATYPE 
{ 

GUID type; 
GUID subtype; 

} 



type 


Major type for matching corresponding media 
types 

GUID NULL means match any type 


subtype 


Subtype for matching corresponding media 
types 

GUID NULL means match any subtype 



HRESULT DMORegister(LPCWSTR szName, REFCLSID rclsidDMO, REFGUID 
rguidCategory, DWORD dwFlags, DWORD cInTypes, const DMO_PARTIAL_MEDIATYPE 
*plnTypes, DWORD cOutTypes, const DMO_PARTIAL_MEDIATYPE *pOutTypes) 

Register a new objectjts category and the media types it supports. 

Parameters 

szName Registration name for this DM0. Names longer 

than 79 characters may be truncated. 
rclsidDMO Class ID the corresponding COM object for the 

DMO is registered under. 
rclsidDMO Class ID the corresponding COM object for the 

DMO is registered under. 
rguidCategory Category of this object 

dwFlags This must be a combination of the following 

flag values (or 0). 

DMO_REGISTERFJS_KEYED 

Object use is restricted to by key 
cInTypes Number of input types to register 
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pliiTypes Input types 

cOutTypes Number of output types to register 

pOutTypes Output types 

Return Values 



HRESULT DMOUnregister(REFCLSID rclsidDMO, REFGUID rguidCategory) 

Unregister a media object from one or all categories. 
Parameters 



rclsidDMO Class ID of the DMO 

rguidCategory Remove from this category 

If this is GUID_NULL unregister this object 

from all categories 



Return Values 



HRESULT DMOEnum(REFGUID rguidCategory, DWORD dwFlags, DWORD 
cInTypes, const DMO_PARTIAL_MEDIA_TYPE *plnTypes, DWORD cOutTypes, 
const DMO_PARTIAL_MEDIA_TYPE *pOutTypes) 

Enumerate Media Objects by category and/or by media type. GUID_NULL means match 
any QUID. 



Parameters 



rclsidDMO 

rguidCategory 
dwFlags 



Class ID the corresponding COM object for the 

DMO is registered under. 

Category of this object 

This must be a combination of the following 

flag values (or 0). 



cInTypes 
pInTypes 
cOutTypes 
pOutTypes 



DMO_REGISTERFJNCLUDE_KEYED 

Include keyed objects 
Number of input types to register 
Input types 

Number of output types to register 
Output types 



Return Values 



Media Type helpers 

Use these functions to manipulate media types. 
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Media types initialized with MolnitMediaType must be freed with MoFreeMediaType. 
Media types created with MoCreateMediaType must be freed with MoDeleteMediaType. 
Media types copied using MoCopyMediaType must be freed using MoFreeMediaType. 
Media types duplicated using MoDuplicateMediaType must be freed using 
MoDeleteMediaType. 



HRESULT MolnitMediaType(DMO_MEDIA_TYPE *pmt. DWORD cbFormat) 

Initialize a media type with a given size format block, pmt is assumed uninitialized on 
input and no attempt is made to free any media type previously in pmt. 

Parameters 



Return Values 

E_,OUTOFMEMORY 

HRESULT MoFreeMediaType(DMO_MEDIA_TYPE *pmt) 

Free a media type previously initialized by MolnitMediaType. 
On return the pbFormat field will be 0. 

Parameters 

pmt Media type to free 

Return Values 

HRESULT MoCopyMediaType(DMO MEDIA.TYPE ^pmtDest, const 
DMO_MEDIA_TYPE *pmtSource) 

Copy media types. 

Parameters 

pmtDest Destination Media Type 

pmtSource Source Media Type 

Return Values 

E_OUTOFMEMORY Could not allocate memory 

HRESULT MoCreateMediaType(DMO_MEDIA_TYPE **ppmt, DWORD cbFormat) 

Create a new media type structure. 
Parameters 



pmt 

CbFormat 



Where to initialize the media type 
Size of format block to create 
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ppmt 
cbFormat 



Where to allocate the new nnedia type 
Size of format block 



Return Values 

E_OUTOFMEMORY 
HRESULT MoDeleteMediaType{DMO_MEDIA_TYPE *pmt) 

Delete a media type allocated by MoCreateMediaType or MoOupicateMediaType() or 

returned by pointer from an API or interface method. 

Parameters 

pmt Media type to delete 

Return Values 

HRESULT MoDupliateMediaType(DMO_MEDIA_TYPE **ppmtDest, const 
DMO^MEDIA.TYPE *pmtSrc) 

Duplicate a media type. 

Parameters 

ppmtDest New type 

pmtSrc Source 

Return Values 



E OUTOFMEMORY 



